home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / cdplayer / scdplayer / scdplayer.doc.eng < prev    next >
Text File  |  1994-07-30  |  6KB  |  204 lines
  1.  
  2.                 SCDPlayer 1.2
  3.             © 1994 Pascal Rullier
  4.                    GiftWare
  5.  
  6.  
  7. Distribuality
  8. -------------
  9. SCDPlayer is Freely Distribuable, but is *NOT* Freeware. The package
  10. *MUST* be complete. No Commercial use must be done with written
  11. permission from his author (see COPYING). 
  12. SCDPlayer is Copyrigth by Pascal Rullier.
  13.  
  14.  
  15. Why this stuff ?
  16. ----------------
  17.  
  18. I have a CDROM drive, and I was tired to use big interfaces just for
  19. playing CD Audio. I found a shell tool called scsiutil, but the using it
  20. by command shell was very heavy. So a wednesday, I decided to make a
  21. GUI for it. It took me only 45 minutes for the GUI creation and the
  22. main loop. The main functions were here : Eject Stop Play, Track,
  23. Unit. SCDPlayer 1.0 was born. Very Small 9ko but a window in the
  24. workbench screen was always here. The next week-end, just a couple of
  25. days, I decided to make SCDPlayer as a commodity, with popup, exchange
  26. controls, tooltypes, all the commodities' stuffs. It was, for me, a
  27. exercice and a very good experience for programming. I look into
  28. sources of a screen blanker, made by my friend François Paulhiac for
  29. the handle. SCDPlayer 1.1 was born.
  30.  
  31.  
  32. Requirements
  33. ------------
  34. Only 2.0+ and 1.5Mo RAM (only when GUI is opened)
  35.  
  36.  
  37. Installation
  38. ------------
  39.  
  40. Copy SCDPlayer (by workbench) into sys:tools/commodities or into your
  41. sys:WBStartup
  42.  
  43.  
  44. Usage
  45. -----
  46.  
  47. From the workbench or from the cli:
  48.  
  49. Select the icon, and edit its information to set the tooltypes with
  50. your local configuration :
  51.  
  52. DEVICE=name    name of your device (default scsi.device)
  53.  
  54. UNIT=number    number of your CDROM unit (default 4)
  55.  
  56. CX_POPUP=YES|NO    You can choose if you want to popup the GUI at the
  57.         launch (default YES)
  58.  
  59. CX_PRIORITY=0    The task priority.
  60.  
  61. CX_POPKEY=keys    The keys to popup the GUI (default control alt s )
  62.  
  63. PUBSCREEN=name    The name of the public screen where SCDPlayer should
  64.         appear. If it can't, it will be opened on the
  65.         workbench screen. If the named public screen is opened
  66.         later, the GUI tries, first, to be opened on it. The
  67.         screen goes to front and the GUI is displayed.
  68.  
  69. DONOTWAIT    Only if you put SCDPlayer in the WBStartup drawer.
  70.  
  71.  
  72. STEP=number    Step for the level in sliders when using keyboards
  73.  
  74.  
  75. VOLUME=number   Set the volume when launching (0<=VOLUME<=255). If this
  76.         parameter is not set, the volume is the hardware volume
  77.  
  78. AUTOPLAY    If set, a CD-DA will be played when it will be inserted.
  79.  
  80.  
  81. UPDATE=number    Number for time update. if number <= 0, the update will be
  82.         done permanently. If it is too big, the displayed time will
  83.         be false.
  84.  
  85.  
  86. The GUI
  87. -------
  88.  
  89. When it is diplayed, you can see 5 slider bars and 10 buttons.
  90. The track will play when the button will be released. Eject the CDROM disk,
  91. Stop it, or Play the current track displayed, TOC to see the table of
  92. contents, Jump to the nex public screen.
  93. If a CD is already playing, SCDPlayer sets the current track and displays
  94. the current time. It doesn't block the playing.  
  95. (This advantage will be lost in the version 1.3 with the CD identification)
  96.  
  97. You have 2 gadgets on the window : the Close hides the GUI but don't
  98. leave SCDPlayer. The Resize gadget changes the window into a window
  99. bar with the track and the time, the cyclic gadget allows to change the
  100. displayed time in the near gadget and in the window title.
  101. - Current      (C:) time from the begin of the track.
  102. - Next in      (N:) remaining time to the next.
  103. - Total        (T:) Total time from the begining of the CD.
  104. - Total end in (E:) Remaining time up to the end of the CD.
  105.  
  106.  
  107. You have also a menu with 3 items: About shows my address for sending
  108. your gifts (it's not a command, you do what you want, but I like
  109. receive gifts such as CDROM Demo or your contribution *8)
  110.  
  111. Hide (keyboard short-cut: Right Amiga H)     Hides the GUI.
  112. Quit (Right Amiga Q)                 Exit SCDPlayer.
  113.  
  114. If SCDPlayer is running, but hidden, the hotkey puts the public screen
  115. (if it exists) most front and displays the GUI, also if you try to
  116. launch another SCDPlayer, the first displays its GUI.
  117.  
  118. If you prefer to use the keyboard, you have some useful keys :
  119.  
  120. Right or Left arrow    You change the current track without playing
  121. Up or Down    arrow    Change track with playing
  122.  
  123. HELP            Displays the info requester.
  124.  
  125. In the second menu, ONLY Read TOC (Amiga Right R) has the same effect as
  126. the gadget TOC. In the third menu, Amiga O or Font...Topaz 8 changes the
  127. GUI font to topaz 8, very useful, if your screen-font is not proportional.
  128.  
  129. The GUI is font adaptative.
  130.  
  131. SCDPlayer detects itself:
  132. - the track change,
  133. - the max number of tracks of the CD.
  134.  
  135. SCDPlayer displays a correct TOC. 
  136. SCDPlayer supports 3.0 Menu Look.
  137. SCDPlayer is volume-sensitive (i.e. if another CD Tool changes the volumes,
  138. SCDPlayer auto-adjusts itself) 
  139.  
  140. The Sliders 
  141.   - In an horizontal way 
  142.     - L  Left  volume.
  143.     - R  Right volume.
  144.     - Vol Global volume.
  145.     
  146.   - The vertical to the balance.  
  147.   
  148. All other menus, gadgets will be implemented in the 1.3 released (End of
  149. September - Exams First !^)  
  150.  
  151.  
  152. The Future
  153. ----------
  154.  
  155. SCDPlayer will edit the track list to do a CD library.
  156. SCDPlayer will have a CD catalog (compatible with others CDPlayers)
  157. SCDPlayer will be able to choose its police for the GUI.
  158. SCDPlayer will save its preferences into the icon.
  159. SCDPlayer will have a random playing.
  160. SCDPlayer will be localized. 
  161.  
  162. Known BUGS *8(
  163. --------------
  164. Some SCSI cards like oktagon have a long answer delay, it doesn't works
  165. very fine.
  166.  
  167. Special Thanks 
  168. --------------
  169. I would like to thanks 
  170.  
  171.     Gary Duncan
  172.     Philips PTS
  173.     23 Lakeside Dr
  174.     Tally-Ho Technology Park
  175.     Burwood East Vic 3151
  176.     Australia
  177.  
  178.     EMail: gduncan@philips.oz.au
  179.  
  180.  
  181.     The Software Brewery
  182.     Dipl. Inform. (FH) Heiko Rath
  183.     Raiffeisenstr.10a
  184.     D-64331 Weiterstadt
  185.     Germany
  186.  
  187.     EMail: hr@brewhr.swb.de
  188.  
  189. Commodity   Greetings to François Paulhiac.
  190. Icon Design Greetings to François Gastaldo.
  191.  
  192. If you have some suggestions, gifts, a chip AMD33C93A (the chip controls
  193. SCSI Bus on an A3000), etc... please send me this to :
  194.  
  195. Pascal Rullier
  196. 25b, rue du Prof Lande
  197. 33380 BIGANOS FRANCE
  198.  
  199. Email :  bugss@frbdx11.cribx1.u-bordeaux.fr (always)
  200. Fidonet: Pascal Rullier 2:324/8.3           (always)
  201.  
  202. Don't forget to support authors : Gary Duncan, Heiko Rath.
  203.  
  204.